home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / lantools / mnetcp11 / mnetcapt.doc next >
Text File  |  1990-08-13  |  8KB  |  183 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                 MNETCAPT.EXE
  8.                               (Screen Capture)
  9.                            written by Robert Laird
  10.  
  11.                                 Version 1.1
  12.                                   8/13/90
  13.  
  14.  
  15.  
  16. ║
  17. ║ MNETCAPT is a TSR which wakes up every minute to see if the Banyan MNET
  18. ║ screen (the initial screen) is present.  If so, MNETCAPT captures the data
  19. ║ for the nine servers showing on the screen, then PgDn's to capture the data
  20. ║ for all the remaining servers (up to 495).  Data is saved in files, one file
  21. ║ for each server: the file name is the current date, the extension is a
  22. ║ consequtive server number.  Data inside the files is in comma-delimited form.
  23. ║
  24. ║ MNETCAPT is a Shareware program.  Use it for 10 days; if you find it useful
  25. ║ and want to use it for your Banyan network, please forward $20 per server to:
  26. ║
  27. ║   Robert Laird                            ║ If you have more than 12 servers,
  28. ║   13164 Memorial Dr.  Suite 126           ║ the fee is $250 for unlimited
  29. ║   Houston, TX 77079                       ║ number of servers.
  30. ║
  31. ║ Comments and suggestions are always welcome.  Please contact me via the HUB
  32. ║ BBS @ 713-627-4922 or via CompuServe 70070,460.
  33. ║
  34. ║ The above fees are hereby waivered for Panhandle Eastern Corporation.
  35. ║
  36.  
  37.  
  38.  
  39.  Loading Procedure for MNETCAPT
  40.  
  41.  1. Login to your Banyan network.
  42.  2. Run SETMSGS OFF.
  43.  3. (optional) Use the MARK program to mark a place in memory, for
  44.     possible future release of the program from memory.
  45.  4. Run MNETCAPT.*
  46.  5. Run MNET.
  47.  6. When all servers are listed, highlight each one and press ENTER to
  48.     select all servers on your network.  Press F10.  When the 'VINES
  49.     Network Summary' screen appears, you are finished.  DO NOT PRESS ANY
  50.     OTHER KEY.
  51.  
  52.  * It is highly recommended that when you run MNETCAPT, that your default
  53.    drive is a "local" PC hard drive (e.g, C:)...  If you have MNETCAPT
  54.    writing to a network drive and the network drive becomes unavailable,
  55.    MNETCAPT will not recover from a "drive not ready" DOS error.
  56.  
  57.  At this point, MNETCAPT waits for the VINES Network Summary screen to
  58.  appear. When that screen is present, and the timer has counted 60
  59.  seconds, MNETCAPT then begins its process of capturing the data from
  60.  all the screens.  (NOTE:  If MNETCAPT does not "see" the proper screen,
  61.  it will emit a low-frequency beep (kind of a grunt) to let you know
  62.  that it woke up and discovered that the proper screen was not available
  63.  for processing.  After this discovery, MNETCAPT will immediately go
  64.  back to sleep for another minute.)
  65.  
  66.  If you watch the screen, you'll see MNETCAPT process each screen of
  67.  server data until there are no more servers.  MNETCAPT then saves the
  68.  data it collected to the appropriate files, then performs a series of
  69.  PgUp keystrokes to return to the top.
  70.  
  71.  Executing the MNETCAPT program more than once will NOT load multiple
  72.  copies into memory. MNETCAPT will sense that it has already been loaded,
  73.  and will abort the attempt. The original MNETCAPT will not be affected
  74.  by this attempt.
  75.  
  76.  Every day, you can take the data from the previous day and load it into
  77.  an application program such as dBASE, Quattro Pro, Lotus, etc., and
  78.  write programs or macros to chart, graph or print the data. (Personally,
  79.  I use (and love) Quattro Pro v1.x; version 2.0 will have 3-D graphs.)
  80.  
  81.  
  82.  Breaks in the routine
  83.  
  84.  In general, it is strongly suggested that you dedicate a PC for running
  85.  MNET and capturing data via MNETCAPT.
  86.  
  87.  However, you may have a reason to "break the routine" by exiting MNET or
  88.  changing to another screen. If you do this, MNETCAPT will not continue
  89.  capturing the screen data. When you return to the 'VINES Network
  90.  Summary' screen, MNETCAPT will again begin to capture the screen. It is
  91.  important to note that your data files will have a break in them. For
  92.  example, a portion of your data file may look like this:
  93.  
  94.          34521,648,HOU.05,0.00,0.00,0.00,90.59,264431,266592,0,0.00
  95.          34521,649,HOU.05,0.01,0.01,0.01,92.39,267246,269332,0,0.00
  96.          34521,658,HOU.05,0.03,0.02,0.02,64.28,269116,271132,0,0.00
  97.          34521,659,HOU.05,0.00,0.00,0.00,80.71,274116,276117,0,0.00
  98.  
  99.  There is a break between minute 649 and 658. If you process your data in
  100.  Lotus, Quattro, dBASE or other application package, make sure you
  101.  account for the possibility of a break such as this.
  102.  
  103.  If you do execute other portions of MNET, it is likely that you will
  104.  return to the VINES Network Summary screen, and the list of servers
  105.  will not be at the "top", i.e., will not show the first server on
  106.  the list of servers as the first server on the screen.  If this is
  107.  the case, make sure you PgUp until you are at the top of the list
  108.  of servers befor MNETCAPT has a chance to capture any more data.
  109.  
  110.  WARNING:  Due to the way that MNET runs on Banyan, it is not advisable
  111.            to stop and start MNET through the normal course of the day.
  112.            If there are no other PCs running MNET, and MNET is stopped
  113.            for any length of time, the Message Averages and other data
  114.            are reset, thus making any previously captured data invalid.
  115.  
  116.  
  117.  
  118.  Technical Description
  119.  
  120.  Written in Turbo Pascal 5.5, this program uses an Interrupt Service
  121.  Routine (ISR) and some special intervention code supplied via the Power
  122.  Tool Plus/5.0 library.  This program, when executed, goes TSR and wakes
  123.  up every minute.  It looks to see if 'VINES Network Summary' exists in
  124.  the top right corner of the screen, and if it does, then captures the 9
  125.  lines of data from MNET, stuffs a PgDn into the keyboard buffer, goes to
  126.  sleep for 5/18ths of a second to let MNET do a PgDn, then wakes up
  127.  again, captures the next 9 lines, etc. After all server info is
  128.  captured, the data is saved to x files, where x is the number of servers
  129.  it found data on. For example, if there are 3 servers and today is
  130.  August 10, 1990, then it would create:
  131.  
  132.                           900810.001
  133.                           900810.002
  134.                           900810.003
  135.  
  136.  Every minute, it appends new data to these files.  The data is parsed
  137.  into comma delimited format.  The first field is the nth minute of the
  138.  day; for example, at 8am, it is 8*60, or 480th minute of the day.  The
  139.  second field is the server name, etc.  No other processes are performed.
  140.  
  141.  The first line of a new day will always be the date; the second line will
  142.  always be the server name.  The first two entries on each subsequent line
  143.  are the Julian date and the minute of the day.  In Quattro or Lotus, the
  144.  Julian date can be formatted with the Range,Format,Date command.
  145.  
  146.  Example of the contents of a data file:
  147.  
  148.          8/10/90
  149.          HOU.05
  150.          34521,648,HOU.05,0.00,0.00,0.00,90.59,264431,266592,0,0.00
  151.          34521,649,HOU.05,0.01,0.01,0.01,92.39,267246,269332,0,0.00
  152.          34521,650,HOU.05,0.03,0.02,0.02,64.28,269116,271132,0,0.00
  153.          34521,651,HOU.05,0.00,0.00,0.00,80.71,274116,276117,0,0.00
  154.  
  155.  
  156.  Future additions
  157.  
  158.  I am anticipating that some users will want the data in SDF format
  159.  instead of comma-delimited format. This change would be fairly easy to
  160.  make, but I will not make it unless it is specifically asked for. I am
  161.  also toying with the idea of saving the data in .DBF format (dBASE), but
  162.  that would make the program considerable larger than the 149K that it is
  163.  now.
  164.  
  165.  If any additional parsing or data reduction is requested (and makes
  166.  sense), I will be happy to consider including it.
  167.  
  168.  At this writing (8/10/90), it is anticipated that within 2 to 6 months,
  169.  Banyan will be releasing the MNET API's. When these API's are available,
  170.  capturing this type of data will be possible without running MNET and
  171.  plucking data off the screen. However, unless someone writes a
  172.  server-based service to collect MNET data, it will still require a
  173.  dedicated PC to be running the collection program.
  174.  
  175.  If you need to capture data for more than 495 servers, I WOULD LOVE TO
  176.  HEAR FROM YOU!
  177.  
  178.  Size:  Loaded, MNETCAPT takes up about 150,000 bytes.  A lot of that
  179.         space is needed for the potential 495 servers and their data.
  180.         If space is a problem, let me know how many servers you have
  181.         and I'll be happy to recompile it to reduce the load size.
  182.  
  183.